package blog.service;

import java.util.HashMap;
import java.util.List;

import com.github.pagehelper.PageInfo;

import blog.entity.Article;

public interface ArticleService {

    /**
     * 查询文章列表(主要用于首页显示文章信息)
     */
    PageInfo<Article> getPageArticleList(Integer pageIndex, Integer pageSize, HashMap<String, Object> paramMap);

    /**
     * 统计已经发布的文章数量(前台不知道有草稿这个说法)
     *
     * @return 文章数量
     */
    Integer countArticle();

    /**
     * 统计文章的浏览次数
     *
     * @return 总的浏览次数
     */
    Integer countArticleView();

    /**
     * 得到最后更新的文章
     *
     * @return 文章
     */
    Article getLastUpdateArticle();

    /**
     * 根据ID查询文章信息
     *
     * @param id
     * @return 文章信息
     */
    Article getArticleById(Integer id);

    /**
     * 查询属于某个分类的前n条文章
     *
     * @param categoryId 分类id
     * @param n          查询几条
     * @return 文章列表
     */
    List<Article> listArticleByCategoryId(Integer categoryId, int n);

    /**
     * 查看访问量最高的前n条文章
     *
     * @param n 要查出前几条
     * @return 文章列表
     */
    List<Article> listArticleByViewCount(Integer i);

    /**
     * 得到下一篇文章 (其实就是查比当前文章id大的第一个)
     *
     * @param articleId 当前文章id
     * @return 文章
     */
    Article getAfterArticle(Integer articleId);

    /**
     * 得到上一篇文章 (其实就是查比当前文章id小的第一个)
     *
     * @param articleId 当前文章id
     * @return 文章
     */
    Article getPreArticle(Integer articleId);

    /**
     * 获得随机前n条文章
     *
     * @param n 要取出的条数
     * @return 文章列表
     */
    List<Article> listRandomArticle(int n);

    /**
     * 获取前n条热评文章
     *
     * @param n 要取出多少条
     * @return 文章列表
     */
    List<Article> listArticleByCommentCount(int n);

    /**
     * 更新文章
     *
     * @param article
     */
    void updateArticle(Article article);

    /**
     * 更新文章的评论数
     *
     * @param articleId
     */
    void updateCommentCount(Integer articleId);


}
